home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / setpgrp.z / setpgrp
Encoding:
Text File  |  2001-04-17  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSEEEETTTTPPPPGGGGRRRRPPPP((((2222))))                                                          SSSSEEEETTTTPPPPGGGGRRRRPPPP((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      setpgrp, BSDsetpgrp - set process group ID (System V and 4.3BSD)
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.    ####iiiinnnncccclllluuuuddddeeee <<<<uuuunnnniiiissssttttdddd....hhhh>>>>
  13.  
  14.    _S_y_s_V:
  15.      ppppiiiidddd____tttt sssseeeettttppppggggrrrrpppp ((((vvvvooooiiiidddd))));;;;
  16.  
  17.    _B_S_D:
  18.      Links with the BSD version automatically:
  19.      iiiinnnntttt BBBBSSSSDDDDsssseeeettttppppggggrrrrpppp((((iiiinnnntttt ppppiiiidddd,,,, iiiinnnntttt ppppggggrrrrpppp))));;;;
  20.  
  21.      Links with the BSD version if -_l_b_s_d is specified during link phase:
  22.      iiiinnnntttt sssseeeettttppppggggrrrrpppp((((iiiinnnntttt ppppiiiidddd,,,, iiiinnnntttt ppppggggrrrrpppp))));;;;
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      The System V version of _s_e_t_p_g_r_p behaves identically to _s_e_t_s_i_d (2).
  26.  
  27.      The BSD version of _s_e_t_p_g_r_p sets the process group of the specified
  28.      process _p_i_d to the specified _p_g_r_p.  If _p_i_d is zero, then the call applies
  29.      to the current process.  If _p_g_r_p is zero and pid refers to the calling
  30.      process, _s_e_t_p_g_r_p() behaves identically to _s_e_t_s_i_d (2).  If the invoker is
  31.      not the super-user, then the affected process must have the same
  32.      effective user-id as the invoker or be a member of the same session as
  33.      the calling process.
  34.  
  35. EEEERRRRRRRROOOORRRRSSSS:::: BBBBSSSSDDDD VVVVEEEERRRRSSSSIIIIOOOONNNN OOOONNNNLLLLYYYY
  36.      _B_S_D_s_e_t_p_g_r_p will fail and the process group will not be altered if one of
  37.      the following occur:
  38.  
  39.      [ESRCH]        The requested process does not exist.
  40.  
  41.      [EPERM]        The effective user ID of the requested process is
  42.                     different from that of the caller and the process is not
  43.                     in the same session as the calling process.
  44.  
  45.      [EACCES]       In the Trusted IRIX environment, the Mandatory Access
  46.                     Control (MAC) label of the calling process is not equal to
  47.                     the MAC label of _p_i_d and the calling process does not have
  48.                     the CCCCAAAAPPPP____MMMMAAAACCCC____RRRREEEEAAAADDDD and CCCCAAAAPPPP____MMMMAAAACCCC____WWWWRRRRIIIITTTTEEEE capabilities(4).
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      exec(2), fork(2), getpgrp(2), getpid(2), intro(2), kill(2), setpgid(2),
  52.      setsid(2), signal(2), capabilities(4), dominance(5).
  53.  
  54. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  55.      The System V version of _s_e_t_p_g_r_p returns the value of the new process
  56.      group ID with no possibility of error.  The BSD version returns 0 if the
  57.      operation is successful.  If the request fails, -1 is returned and the
  58.      global variable _e_r_r_n_o is set to indicate the reason.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSEEEETTTTPPPPGGGGRRRRPPPP((((2222))))                                                          SSSSEEEETTTTPPPPGGGGRRRRPPPP((((2222))))
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         PPPPaaaaggggeeee 2222
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.